home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / lib / tex / inputs / amstexsiam-doc.tex < prev    next >
Encoding:
Text File  |  1991-05-21  |  9.1 KB  |  207 lines
  1. % This is the file siamdoc.tex.  Typeset with plain TeX.
  2. \magnification=\magstephalf
  3. \tolerance=1000
  4. \def\beginverbatim{\par\begingroup\setupverbatim\doverbatim}
  5. {\catcode`\|=0 \catcode`\\=12 % | is temporary escape character
  6.   |obeylines|gdef|doverbatim^^M#1\endverbatim{#1|endgroup}}
  7. \def\setupverbatim{\tentt \obeylines \uncatcodespecials \obeyspaces}
  8. {\obeyspaces\global\let =\ } % let active space = control space
  9. \def\uncatcodespecials{\def\do##1{\catcode`##1=12}\dospecials}
  10. {\catcode`\^^M=13 \gdef\gobblecr{\ifnextchar
  11. {\gobble}{\ignorespaces}}}
  12. {\catcode`\ =\active\gdef\vobeyspaces{\catcode`\ \active \let \xobeysp}}
  13.  \def\xobeysp{\leavevmode{} }
  14. \begingroup \catcode `|=0 \catcode `[= 1
  15. \catcode`]=2 \catcode `\{=12 \catcode `\}=12
  16. \catcode`\\=12 |gdef|@xverbatim#1\end{verbatim}[#1|end[verbatim]]
  17. |gdef|@sxverbatim#1\end{verbatim*}[#1|end[verbatim*]]
  18. |endgroup
  19. \def\makeother#1{\catcode`#112\relax}
  20. \def\verb{\begingroup \tt \uncatcodespecials
  21. \averb}
  22. \def\sverb#1{\def\tempa ##1#1{##1\endgroup}\tempa}
  23. \def\averb{\obeyspaces \frenchspacing \sverb}
  24. \font\textfontii = cmsy10
  25. \font\eightpt = cmr8
  26. \def\heading#1{\medskip\noindent{\bf #1.\ }}
  27. \def\AmSTeX{{\textfontii A}\kern-.1667em\lower.5ex\hbox
  28.  {\textfontii M}\kern-.125em{\textfontii S}-\TeX}
  29. \def\qed{\ifhmode\unskip\nobreak\fi\ifmmode\ifinner\else\hskip5pt\fi\fi
  30.  \hbox{\hskip5 pt \lower 1.5 pt\hbox{\vrule width .2 pt 
  31.  \vbox{\hrule width 4 pt height .2 pt \vskip 7.1 pt
  32.  \hrule width 4 pt height .2 pt }\unskip\vrule width .2 pt}}}
  33. \centerline{\bf USING  THE \AmSTeX\ SIAM STYLE FILE}
  34. \medskip
  35. {\eightpt\centerline{DOUGLAS N. ARNOLD and BRADLEY J. LUCIER}}
  36. \bigskip
  37. This document explains the use  of the \AmSTeX\ SIAM style file to produce
  38. a paper that is well on its way to being
  39. typographically acceptable for publication
  40. in a SIAM journal.  The \AmSTeX\ SIAM style file (amstexsiam.sty) is
  41. a modification of the \AmSTeX\ style file, amsppt.sty.
  42. We assume familiarity with \AmSTeX\ and amsppt,
  43. as documented in
  44. {\it The Joy of \TeX\ }
  45. by Michael Spivak.
  46.  
  47. Most of the points introduced below are illustrated in
  48. the nonsense paper {\it A sample paper to illustrate the
  49. \AmSTeX\ SIAM style file}.
  50.  
  51. \heading{Publication information}  When the paper has been accepted,
  52. this must be noted in the \TeX\ input file using the macro \verb"\accepted",
  53. and various information must be given
  54. after the \verb"\documentstyle" command to correctly format
  55. the first page of the paper and the running heads.  This information
  56. consists of the beginning page number of the article,
  57. the journal name, the issue volume, the issue number, 
  58. the month of appearance, the year of appearance, 
  59. the place of the paper in the issue, the head for even pages, and
  60. the head for odd pages, as in the following example:
  61. \medskip
  62. \beginverbatim
  63. \accepted
  64. \pageno=10
  65. \def\journalname{{\sixrm SIAM J. M{\fiverm ATH.} A{\fiverm NAL.}}}
  66. \def\issuevolume{1}
  67. \def\issuenumber{2}
  68. \def\issuemonth{February}
  69. \def\issueyear{1988}
  70. \def\placenumber{002}
  71. \def\evenhead{bradley j\. lucier and douglas n\. arnold}
  72. \def\oddhead{a sample paper}.
  73. \endverbatim
  74. \medskip
  75. \noindent The even and odd heads can be given even before the paper has been
  76. accepted.
  77.  
  78. \heading{Title} Use \verb"\title" and \verb"\endtitle".
  79. Type the title in all caps.
  80. Attach any footnotes that apply to the paper
  81. as a whole to the title.
  82.  
  83. \heading{Author} Use \verb"\author" and \verb"\endauthor".
  84. Type the author's name in all caps.  For multiple authors type the word
  85. ``and'' in lowercase.
  86.  
  87. \heading{Author's affiliation}  Give the  affiliation of each author
  88. in a footnote attached to each author's name.  Statements
  89. acknowledging support should be contained in the same footnote.
  90. Do {\it not} use the \verb"\affil" or \verb"\address" macros.
  91.  
  92. \heading{Footnotes} Use \verb"\footnote".
  93. For the topmatter, use footnote symbols.
  94. In the rest of the paper
  95. use numbered footnotes. 
  96. The order of footnote symbols is star (*\thinspace = \thinspace\verb"*"), dagger
  97. (\dag\thinspace =\thinspace \verb"\dag"), double-dagger (\ddag\thinspace =\thinspace \verb"\ddag"),
  98. section-marker (\S\thinspace = \thinspace\verb"\S").
  99.  
  100. \heading{Abstract} Use \verb"\abstract".
  101.  
  102. \heading{Keywords} Use \verb"\keywords" with commas between keywords
  103. but without ending punctuation.
  104.  
  105. \heading{Subject classifications} Use \verb"\subjclass"
  106. with commas between classifications
  107. but without ending punctuation.
  108.  
  109. \heading{Headings} Use \verb"\subheading" without ending punctuation.
  110. The argument shall begin with the section number followed by a period
  111. and then the section name with only the first word capitalized.
  112. Very long papers could use \verb"\heading" and \verb"\subheading".  If
  113. \verb"\heading" is used start heading name with a section mark
  114. (\S\thinspace =\thinspace\verb"\S") and the section number followed by a period and the
  115. section title with the first letter of each major word capitalized.
  116.  
  117. \heading{Equation numbers}  Use \verb"\tag".
  118.  
  119. \heading{Theorems, etc} Use \verb"\proclaim" and \verb"\endproclaim"
  120. for theorems, lemmas, corollaries, claims, propositions, etc.  The
  121. argument to \verb"\proclaim" takes no ending punctuation.
  122.  
  123. \heading{Definitions} Use \verb"\proclaim" and \verb"\endproclaim",
  124. but use \verb"\rm" to set the body of the definition in roman.
  125.  
  126. \heading{Proofs, etc} Use \verb"\demo" and \verb"\enddemo"
  127. for proofs, examples, remarks, cases, etc.  The
  128. argument to \verb"\demo" takes no ending punctuation.  The
  129. end-of-proof mark is an open box (\qed\thinspace =\thinspace\verb"\qed").
  130.  
  131. \heading{Lists and sublists}  Use \verb"\roster" and \verb"\endroster".
  132. Rosters use default labels of the form (1), (2), etc.
  133. Subrosters are permitted.  Each subroster {\it must} be enclosed
  134. in a separate pair of braces. Subrosters are not standard \AmSTeX.
  135.  
  136. \heading{References} These can be done exactly as in {\it The Joy
  137. of \TeX.}  Use \verb"\Refs" and \verb"\ref".
  138.  
  139. \heading{Table of contents} There are no special macros provided to set
  140. a table of contents.  If a table of contents is desired, follow these
  141. guidelines.  Switch to eight point type (\verb"\eightpoint").
  142. Center the word ``CONTENTS'' in caps.  Capitalize only the first word
  143. of entries.  Runover lines align with the start of entries.
  144. Place the section number flush left with one em to section title,
  145. spaced dots from end of entry to page number, and two ems between the
  146. dots and page number.  Leave 18--20 points of vertical space, baseline
  147. to baseline, to the text above and below.
  148.  
  149. \heading{Figure legends} Use \verb"\topspace" or \verb"\midspace".
  150. Set the caption as, for example,
  151. \verb"\topspace{3 in}\caption{\eightpoint{\smc Fig\. 1.\enspace}\it Type caption here.}".
  152.  
  153. \heading{Tables} There are no special macros provided to set
  154. tables.  Follow these guidelines.
  155. Switch to eight point type (\verb"\eightpoint").
  156. Center the table on the page width.  Put a minimum
  157. of  18 points
  158. space (baseline to baseline) above and/or below the table.
  159. Center the label over the table.  The label
  160. should be of the form \verb"{\smc Table~1.}"  The title of the table should
  161. be in italics centered over the table with only the first word capitalized.
  162. Column headings may be in set in six point type if necessary to fit properly
  163. over the columns.  Place  half point rules
  164. above and below the column headings, and at the end of the table.
  165.  
  166. \heading{New control sequence in the \AmSTeX\ SIAM style file}
  167. The amount that each roster is indented is controlled by the value of
  168. \verb"\rosterindent".  For most lists the default value need not
  169. be changed.
  170.  
  171. \heading{Fonts} The font \verb"cmcsc10" is
  172. used at 8 point (\verb"cmcsc10 at 8 pt") so there is a
  173. caps-and-small-caps font for use in abstracts, etc.  You must
  174. have the appropriate \verb"pxl", \verb"pk" or \verb"gf" file for
  175. your printer driver. (See your local \TeX\ guru.  He or she may 
  176. generate the font in the right size using Metafont.) 
  177. Or, you can redefine the font \verb"\eightsmc"
  178. to be whatever you can use for an eight point caps-and-small-caps font.
  179. If you have absolutely no eight point caps-and-small-caps font, then
  180. give the command \verb"\font\eightsmc=cmr8" to substitute
  181. eight point roman.  SIAM can change it later if necessary.
  182.  
  183. The file uses
  184. the newer \verb"cm" (computer modern) family of fonts (\verb"cmr9",
  185. \verb"cmr8", \verb"cmr6", \verb"cmmi9", \verb"cmmi8", \verb"cmmi6",
  186. \verb"cmsy9", \verb"cmsy8", \verb"cmsy6", \verb"cmbx9", \verb"cmbx8",
  187. \verb"cmbx6", \verb"cmti9", \verb"cmti8", \verb"cmsl9", \verb"cmsl8",
  188. \verb"cmcsc10", and \verb"cmcsc10 at 8 pt"), so you
  189. will have to change these references to the appropriate \verb"am"
  190. (almost modern) fonts
  191. if that is all you have available
  192. at your site.  The style file also assumes the
  193. existence of the American Mathematical Society fonts
  194. \verb"msxm9", \verb"msxm8", \verb"msxm6", \verb"msym9", \verb"msym8",
  195. and \verb"msym6".  If you do
  196. not have these fonts, then comment out the lines in amstexsiam.sty that
  197. reference
  198. them.
  199.  
  200. \heading{Control sequences defined in the amsppt style but not in the \AmSTeX\ SIAM style}
  201. The commands
  202. \verb"\affil", \verb"\endaffil", \verb"\address", \verb"\date", and
  203. \verb"\thanks" have been redefined to give error messages when used, because
  204. their function has been taken over by other constructions, mainly footnotes
  205. to the title of the paper and the authors' names.
  206. \bye
  207.